Property Value

The focus object or null/Nothing if there is no focus object.

The default value is null/Nothing.

Comments

The FocusObject property defines the object (item or cell) that is the focus object.

The current item or cell is the item or cell that has the focus rectangle. The focus object is rendered with a focus rectangle based on the ShowFocusRectangle property.

The focus rectangle is controlled using the ShowFocusRectangle property. The size of the focus rectangle is consistent with the current selection style (SelectionStyle).

The focus item or cell is not necessarily also selected (ItemClass.Selected or CellClass.Selected).

When the user changes the current item or cell, the FocusObjectChange event occurs. The SelectionChange event occurs when the selection changes.

If item selection is active, the focus object is an item (ItemClass), otherwise cell selection is active and the focus object is a cell (CellClass).

The FocusItem and FocusCell properties also define the focus object and are identical to the FocusObject property but accept an item (ItemClass) or a cell (CellClass) instead of the more generic object class.